package com.service;

import com.bean.ShoppingCart;
import com.utils.PageInfo;

import java.util.List;

public interface ShoppingCartService {
    /**
     * 根据购物车项 ID 获取购物车项信息
     * @param cartId 购物车项的唯一标识
     * @return 对应的购物车项对象，如果未找到则返回 null
     */
    ShoppingCart getShoppingCartById(Integer cartId);

    /**
     * 分页模糊查询用户的购物车信息
     * @param userId 用户的唯一标识
     * @param keyword 模糊查询关键字，可用于匹配书籍标题、作者等信息
     * @param pageNum 当前页码
     * @param pageSize 每页记录数
     * @return 包含分页信息的购物车项列表
     */
    PageInfo<ShoppingCart> getShoppingCartsByUserIdWithKeyword(Integer userId, String keyword, int pageNum, int pageSize);

    /**
     * 插入新的购物车项信息
     * @param shoppingCart 包含新购物车项信息的对象
     * @return 插入操作是否成功，成功返回 true，失败返回 false
     */
    boolean insertShoppingCart(ShoppingCart shoppingCart);

    /**
     * 根据购物车项 ID 更新购物车项信息
     * @param shoppingCart 包含要更新的购物车项信息的对象，其中 cartId 用于定位记录
     * @return 更新操作是否成功，成功返回 true，失败返回 false
     */
    boolean updateShoppingCart(ShoppingCart shoppingCart);

    /**
     * 根据购物车项 ID 删除购物车项信息
     * @param cartId 要删除的购物车项的唯一标识
     * @return 删除操作是否成功，成功返回 true，失败返回 false
     */
    boolean deleteShoppingCartById(Integer cartId);
}